home *** CD-ROM | disk | FTP | other *** search
/ PC Advisor 2004 February / PC Advisor February 2004.iso / trial / Dolphin / 044UD3521.exe / Sam / samssilb / SAM to SSIL Interface.txt next >
Text File  |  2003-04-03  |  5KB  |  142 lines
  1. SAM to SSIL Interface
  2.  
  3. This is an interface module for 16-bit SSIL drivers. It works best in
  4. Windows 95.
  5.  
  6. Each driver most be stored in a separate subdirectory and requires an
  7. SIF file to register it with SAM. SAMSSIL scans all SIF files in all
  8. subdirectories when it starts up.
  9.  
  10. This SAM driver consists of 4 DLLs and an EXE:
  11.  
  12. SAMSSILB - The main 32-bit end of the driver.
  13. SAMSSILC - A thunking interface for Windows 95. (Not NT.)
  14. SAMSSILA - 16-bit end of the thunk for communication with 16-bit SSIL DLLs.
  15. SAMSSILD - A 16-bit interface to the Windows NT server.
  16. SAMSSILE - A 16-bit application for Windows NT to use SSIL drivers.
  17.  
  18.  
  19. SSIL Installation File - SIF
  20.  
  21. These SIF files describe the available 16-bit SSIL drivers that the SAM to 
  22. SSIL interface can use. Because some SSIL drivers need to be copied
  23. into the Windows directory and some have a common SSIL.INI file,
  24. SAMSSILB will copy the relevant files to the correct place, making the
  25. appropriate INI file modifications when you change synthesizer.
  26.  
  27. Having an INI file modification section avoids the need for duplicated
  28. directories and drivers where only one line in the INI file is different.
  29.  
  30. WARNING - When you change synthesizer driver SAM will DELETE the 
  31. old SSIL files from wherever it copied them to. Therefore you should
  32. only make modifications to SSIL drivers and associated files in the
  33. original source directory. 
  34.  
  35. To force SAMSSIL to re-copy an SSIL driver just use its configuration
  36. dialog box and hit ENTER, without changing the synthesizer selection
  37.  
  38. The sections in each SIF file are as follows:
  39.  
  40. It is mandatory to have an [SSIL Driver] section.
  41.  
  42. SIF files must be stored in the subdirectory that contains the 
  43. SSIL driver. You can have more than one SIF file per driver. SIF files
  44. are never copied anywhere.
  45.  
  46. [SSIL Driver] ; this section is required
  47.  
  48. Description= Text description of synthesizer and it's connection.
  49.  
  50. DLLname= Name of the actual SSIL driver DLL.
  51.  
  52. DestinationDirectory=   Identifier of directory to install 
  53.             the driver DLL to:
  54.                 1 = SAMSSILB directory
  55.                 2 = Windows directory
  56.                 3 = Windows system directory
  57.                 4 = Leave it in the source directory
  58.                 5 = Custom (see below)
  59.  
  60. SafeDetect=    
  61.     0 - Driver cannot safely detect a synthesizer.
  62.  
  63.     1 - Driver detects a synthesizer safely. This means that this driver
  64.     can be loaded, and DR_OPENDRIVER and DR_OPENUNIT can be used. 
  65.     These functions should return "failed" if the correct synthesizer is
  66.     not present and should succeed if it is. They should not crash,
  67.     hang the machine, if the synthesizer is not present.
  68.     The driver should also be able to be loaded and unloaded more than
  69.     once in a single Windows session, and you must be able to reopen a
  70.     closed driver without 1st unloading the driver DLL.
  71.                       
  72.     If this is set to 1 then SAM will try to use this driver when it is
  73.     searching for a synthesizer. If both DR_OPENDRIVER and DR_OPENUNIT
  74.     return TRUE (success) SAM will assume that the synthesizer has been
  75.     detected successfully. If either return FALSE SAM will unload the
  76.     driver.
  77.  
  78. NT=
  79.     0 - Driver cannot be safely used under NT. Such drivers may crash, or
  80.     otherwise fail to work because they access hardware directly.
  81.  
  82.     1 - Driver can be safely used under NT.
  83.     Only some of the drivers are flagged as 'working under nt'. We have
  84.     only flagged those drivers that we have been able to test. Some other
  85.     drivers may work but have not been tested by us.
  86.  
  87. ContextSwitch=
  88.  
  89.     This setting determines how SAM tells the driver to change voice
  90.     parameters. 
  91.  
  92.     0 - Driver does not use context switching in the SSIL driver. This is
  93.     the best option if you wan't reliable voice command changes. This is the
  94.     default option.
  95.  
  96.     1 - Driver uses context switching. This may speed up the response time
  97.     in some drivers. However, you may find that some voice commands are
  98.     not reliable. If you use the same voice (name, speed, pitch, etc) for
  99.     all of your software then this is the faster method.
  100.  
  101. [INI File] ; this section is optional
  102.  
  103. INIname= Name of INI file that needs to be modified (if any).
  104.  
  105. DestinationDirectory=     Identifier of directory to copy 
  106.             the INI file to:
  107.             1 = SAMSSILB directory
  108.             2 = Windows directory
  109.             3 = Windows system directory
  110.             4 = Leave it in the source directory
  111.             5 = Custom (see below)
  112.  
  113. [INI Modifications]
  114. NumberOfMods= Number of modifications to make to the above INI file
  115.  
  116. ModXSection= Heading of the section to be modified
  117.  
  118. ModXLabel= Label of the entry to be modified
  119.  
  120. ModXEntry= The value to assign to the modified entry
  121.  
  122.            (where X lies between 1 and NumberOfMods)
  123.  
  124.  
  125. Custom configurations.
  126.  
  127. If the destination directory is 5 then the source directory should be
  128. the FULL PATH to the directory of the driver DLL. No files will be
  129. copied. Use this option if the SSIL DLL has to be in a different
  130. location. If you are building one you can set the SourceDirectory to
  131. point to your build directory.
  132.  
  133. Driver Updates
  134.  
  135. The latest drivers can be found on Arkenstones ftp server, at 
  136. ftp.arkenstone.org/pub/techinfo/ssil, however if you download any you will
  137. have to modify or create SIF files for them. In addition it is not clear
  138. which drivers are the latest version because none of the driver files
  139. created by Arkenstone have a version number. 
  140.  
  141.  
  142. END OF FILE.